home *** CD-ROM | disk | FTP | other *** search
/ The Hacker Chronicles - A…the Computer Underground / The Hacker Chronicles - A Tour of the Computer Underground (P-80 Systems).iso / network / nia29 < prev    next >
Text File  |  1992-09-26  |  19KB  |  383 lines

  1.   ZDDDDDDDDDDDDDDDDDD? IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; ZDDDDDDDDDDDDDDDDDD?
  2.   3   Founded By:    3 :  Network Information Access   : 3 Mother Earth BBS 3
  3.   3 Guardian Of Time 3D:            01APR90            :D3  NUP:> DECnet    3
  4.   3   Judge Dredd    3 :       Guardian Of Time        : 3Text File Archives3
  5.   @DDDDDDDDBDDDDDDDDDY :            File 29            : @DDDDDDDDDBDDDDDDDDY
  6.            3           HMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM<           3
  7.            3          IMMMMMMMMMMMMMMMMMMMMMMMMMMMMM;              3
  8.            @DDDDDDDDDD: VMS System Manager's Manual :DDDDDDDDDDDDDDY
  9.                       :        Chapter 5.11         :
  10.                       HMMMMMMMMMMMMMMMMMMMMMMMMMMMMM<
  11.  
  12. $Chapter 5 Begin
  13.  
  14. PERFORMING BATCH AND PRINT OPERATIONS
  15.  
  16. If you have a printer on your system, or if you want to use batch
  17. processing on your system, then you MUST us queues.  A queue allows users
  18. to submit requests for printing or batch processing, and the system prints
  19. or processes the users' jobs as resources allow.
  20.  
  21. The system manager is responsible for setting up batch and print queues
  22. and making sure that they function properly.  This chapter describes how
  23. to set up (initialize)  and maintain batch and print queues for you system
  24. or cluster.
  25.  
  26. Setting up and maintaining batch and print queues are closely related
  27. system management tasks.  However, you are not required to set up both
  28. types of queues if you need only one type.  In a VAXcluster environment,
  29. queues can be accessed from any node on the cluster.
  30.  
  31. 5.1  GENERIC QUEUES AND EXECUTION QUEUES
  32.  
  33. In the VMS operating system, batch and print operations support two types
  34. of queues: generic queues and execution queues.
  35.  
  36. An execution queue is a queue through which the job (either print or
  37. batch) is actually processed or executed.  For printing, an execution
  38. queue is associated with a specific printer; for batch processing in a
  39. VAXcluster environment, and execution queue is associated with a specific
  40. node.  When a print or batch job is submitted to an execution queue, the
  41. job is ultimately printed on the output device associated with that queue or
  42. processed on the associated batch queue.
  43.  
  44. A generic queue is an intermediate queue that holds a job until an
  45. appropriate execution queue becomes available to initiate the job.  Users
  46. can submit jobs to a generic queue, and the generic queue then directs the
  47. job to an appropriate execution queue; alternatively, users can submit
  48. jobs directly to an execution queue.
  49.  
  50. For example, suppose you have a system with several printers.  You would set
  51. up individual execution queues for each of the printers,  and you could
  52. also set up a generic queue, and the generic queue would subsequently
  53. direct the print job to an available printer.
  54.  
  55. For batch processing, generic queues are often used in clustered systems
  56. to distribute the workload across several nodes.  For example, suppose you
  57. have a Local Area VAXcluster environment with each of the satellite nodes
  58. having a batch processing queue.  You could then establish a generic batch
  59. queue for the cluster.  When users submit batch jobs to the generic queu,
  60. the generic queue would direct individual batch jobs to the execution
  61. queue that is best able to handle the workload.
  62.  
  63. If you only have a single printer for your system or cluster, or if you
  64. only establish a single batch queue, then there is no value in
  65. establishing generic queues.
  66.  
  67. 5.2  SETTING UP QUEUES
  68.  
  69. Set up your queues by including the appropriate commands in your
  70. site-specific startup file,SYS$MANAGER:SYSTARTUP_V5.COM.  Section 2.4.3
  71. describes the commands that should be included in SYSTARTUP_V5.COM, and this
  72. section summarizes them.
  73.  
  74. To establish and use queues, you must first start the queue manager and
  75. identify a queue file.  To do this, include the following command in
  76. SYS$MANAGER:SYSTARTUP_V5.COM, making sure that this command appears before
  77. any other queue commands:
  78.  
  79. $ START/QUEUE/MANAGER/RESTART SYS$COMMON: [SYSEXE] JBCSYSQUE.DAT
  80.  
  81. If you have a cluster, you should use only one queue file for the cluster.
  82. Make sure that the queue file is on a disk that is accessible to all of the
  83. nodes in the cluster from which you may want to submit batch or print jobs.
  84.  
  85. When you create a generic queue, you specify a list of execution queues to
  86. which the generic queue ultimately directs jobs.  In a VAXcluster
  87. environment, the execution queues that you specify for a generic queue can
  88. be on the same node as the generic queue, and they can also be on different
  89. nodes within the cluster.
  90.  
  91. Once you have established the queue file, you can set up individual
  92. execution queues and generic queues by using the INITIALIZE/QUEUE command in
  93. your SYSTARTUP_V5.COM file.  Be sure to initialize execution queues before
  94. initializing the generic queues.  For example, you could include the
  95. following series of commands to set up execution and generic queues for
  96. batch and print operations in a VAXcluster environment.
  97.  
  98. $ INITIALIZE /QUEUE /ON=BLUE::LPA0 /START  BLUE_LPA0                 (1)
  99. $ INITIALIZE /QUEUE /ON=GREEN::LPA0 /START GREEN_LPA0                (2)
  100. $ INITIALIZE /QUEUE /GENERIC=(BLUE_LPA0,GREEN_LPA0) /START SYS$PRINT (3)
  101. $
  102. $ INITIALIZE /QUEUE /BATCH /ON=BLUE:: /START BLUE_BATCH              (4)
  103. $ INITIALIZE /QUEUE /BATCH /ON=RED:: /START RED_BATCH                (5)
  104. $ INITIALIZE /QUEUE /BATCH /GENERIC=(BLUE_BATCH,RED_BATCH) /START SYS$BATCH
  105.   (6)
  106.  
  107. This series of commands in SYSTARTUP_V5.COM does the following:
  108.  
  109. (1) Sets up an execution printer queue associated with LPA0 on node BLUE with a
  110.     queue name of BLUE_LPA0.
  111.  
  112. (2) Sets up an execution printer queue associated with LPA0 on node GREEN with a
  113.     queue name of GREEN_LPA0.
  114.  
  115. (3) Sets up a generic print queue for the cluster.  The generic print queue
  116.     has the name SYS$PRINT and directs print jobs either to BLUE_LPA0 or to
  117.     GREEN_LPA0.
  118.  
  119. (4) Sets up an execution batch queue on node BLUE with the queue name
  120.     BLUE_BATCH.
  121.  
  122. (5)  Sets up an execution batch queue on node RED with the queue name
  123.      RED_BATCH.
  124.  
  125. (6)  Sets up a generic batch queue for the cluster.  The generic batch queue
  126.      has the name SYS$BATCH.  When a job is submitted to SYS$BATCH, this
  127.      generic queue directs the job either to BLUE_BATCH or to RED_BATCH.
  128.  
  129. If you want to set up a terminal as an execution queue, use exactly the same
  130. procedure as for setting up print queues and use the /DEVICE=TERMINAL
  131. qualifier in your INITIALIZE command line.
  132.  
  133. 5.3  MAINTAINING BATCH AND PRINT QUEUES
  134.  
  135. Once you have modified SYS$MANAGER:SYSTARTUP_V5.COM to establish your queues
  136. properly, they will be set up and available every time that your system is
  137. booted.  From time to time, however, some additional maintenance of your
  138. queues may be needed.
  139.  
  140. The VMS operating system provides several DCL-level commands that you can
  141. use to manage your queues.  Tabl 5-1 shows some of the commands that are
  142. available for queue management.  More information about these commands is
  143. available in the VMS GENERAL USER'S MANUAL.
  144.  
  145. ZDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD?
  146. 3TABLE 5-1 QUEUE MANAGEMENT COMMANDS                                           3
  147. CDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD4
  148. 3SET QUEUE :  Allows you to change the attributes of a queue (for example,     3
  149. 3             the number of jobs that can execute simultaneously in a batch    3
  150. 3             queue) without having to stop the queue, initialize it, and      3
  151. 3             then restart it.                                                 3
  152. 3                                                                              3
  153. 3SHOW QUEUE:  Provides the status of queues, listing the jobs that are         3
  154. 3             currently executing, as well as the jobs that have not yet       3
  155. 3             begun execution.                                                 3
  156. 3                                                                              3
  157. 3STOP /QUEUE: Allows you to pause a queue temporarily.  Using the appropriate  3
  158. 3             qualifiers, you can use the STOP /QUEUE command to stop jobs     3
  159. 3             that are currently executing, to stop a queue after the          3
  160. 3             completion of all jobs that are currently executing, to shut down3
  161. 3             the queue manager on the node from which you execute the command,3
  162. 3             and to perform other related function.                           3
  163. 3                                                                              3
  164. 3START /QUEUE: Resumes execution of a queue that has been temporarily halted   3
  165. 3              by the STOP /QUEUE command.                                     3
  166. 3                                                                              3
  167. 3STOP /QUEUE /MANAGER: Shuts down the queue manager on the node from which     3
  168. 3                      you execute the command.                                3
  169. 3                                                                              3
  170. 3START /QUEUE /MANAGER: Starts the queue manager on the node from which you    3
  171. 3                       execute the command.                                   3
  172. @DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDY
  173.  
  174. 5.4  MONITORING JOBS
  175.  
  176. As system manager, you use SHOW QUEUE as the primary command to monitor the
  177. overall status of a queue.  The SHOW QUEUE command displays the status of
  178. each queue selected, and it also shows the status of all jobs in each of the
  179. selected queues.  With SHOW QUEUE, you can also obtain a summary of the
  180. status of jobs in each queue by using the /SUMMARY qualifier.
  181.  
  182. Additionally, you can also use the SHOW ENTRY command to monitor the status
  183. of jobs belonging to a particular user, or to determine the status of
  184. individual batch and print jobs.  SHOW ENTRY and SHOW QUEUE each provide
  185. complete information about jobs, but SHOW QUEUE also provides status
  186. information about the queues themselves.  SHOW ENTRY  generally provides a
  187. faster response time than SHOW QUEUE.  For a full description of the SHOW
  188. ENTRY and SHOW QUEUE commands, see the REFERENCE SECTION of the VMS GENERAL
  189. USERS MANUAL.
  190.  
  191. The following list describes the types of jobs status returned by the SHOW
  192. QUEUE and SHOW ENTRY commands:
  193. ZDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD?
  194. 3STATUS                      DESCRIPTION                                   3
  195. 3                                                                          3
  196. 3Aborting                    Executing job is terminating                  3
  197. 3Executing                   Job is executing from a batch queue           3
  198. 3Holding                     Job is being held until explicitly released   3
  199. 3Holding until               Job is being held until a specified time      3
  200. 3Pending                     Job is in a waiting state                     3
  201. 3Printing                    Job is executing from a printer or terminal   3
  202. 3                            queue                                         3
  203. 3Processing                  Job is executing for a server queue           3
  204. 3Retained on Completion      Job remains in the queue upon completion      3
  205. 3Retained on Error           Job remains in the queue upon encountering an 3
  206. 3                            error                                         3
  207. 3Waiting                     Symbiont refuses the job                      3
  208. @DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDY
  209.  
  210. 5.4.1 DELETING JOB
  211.  
  212. Under certain circumstances, it is necessary to terminate an executing batch
  213. or print job.  For example, you may need to terminate a program that has
  214. entered an endless loop or a job that is executing on a faulty print device.
  215.  
  216. Follow this procedure to delete a job:
  217.  
  218. 1.  Determine the entry number of the job
  219. 2.  Delete the job by entering the DELETE/ENTRY command
  220.  
  221. The DELETE/ENTRY command is restricted to user with either OPER privilege, E
  222. access to the queue, or D access to the specified job.
  223.  
  224. For example, assume that you observe a job that appears to be processing in
  225. an endless loop and is using an inappropriate amount of system resources.
  226. You can delete the job by entering the command DELETE/ENTRY=entry_number.
  227. To determine the entry number, enter the command SHOW
  228. QUEUE/BATCH/ALL/BY_JOB_STATUS=EXECUTING.  The following example shows how to
  229. determine the entry number and delete the job:
  230.  
  231. $  SHOW QUEUE/BATCH/ALL/BY_JOB_STATUS=EXECUTING
  232.  
  233. Batch queue ZEUS_BATCH, on ZEUS
  234.  
  235.  jobname        Username   Entry  Status
  236.  -------        --------   -----  ------
  237.  2307smrcl      MARCO      1719   Executing
  238.  TEST           JONES      1720   Executing
  239.  
  240. $ DELETE/ENTRY=1719
  241.  
  242. 5.2.2 RETAINING JOBS IN A QUEUE
  243.  
  244. To retain a job in a queue after it has been processed, specify the /RETAIN
  245. qualifier with the INITIALIZE/QUEUE START/QUEUE, or SET QUEUE command.  The
  246. /RETAIN qualifier has the following format:
  247.  
  248. /[NO]RETAIN[=option]
  249.  
  250. By using the ERROR option with the /RETAIN qualifier, you indicate that the
  251. jobs in a queue will be held if they do not successfully complete.  A job
  252. that has been held by the /RETAIN=ERROR qualifier can later be released or
  253. requeued after the problem that caused the error has been resolved.
  254.  
  255. By default, jobs are NOT retained.
  256.  
  257. For example, to retain print jobs that do not successfully complete, you
  258. could include the following command in your SYSTARTUP_V5.COM file, after you
  259. have initialized and started the queue:
  260.  
  261. $ SET QUEUE /RETAIN=ERROR GREEN_LPA0
  262.  
  263. 5.4.3  MODIFYING JOB PROCESSING ATTRIBUTES
  264.  
  265. You can modify certain job processing attributes by specifying qualifiers with
  266. the command SET ENTRY entry-number, as shown in the following table:
  267.  
  268. ZDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD?
  269. 3Qualifier               Description                                         3
  270. CDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD4
  271. 3/[NO]AFTER              Controls whether a job is held until a specified    3
  272. 3                        time                                                3
  273. 3/[NO]HOLD                Controls whether a job is available for immediate  3
  274. 3                         processing or held until it is released for        3
  275. 3                         processing                                         3
  276. 3/NAME                    Specifies a new name for a job                     3
  277. 3/[NO]PASSALL             Specifies whether the symbiont bypasses all        3
  278. 3                         formatting and sends the output directly to the    3
  279. 3                         device driver                                      3
  280. 3/PRIORITY                Specifies the relative scheduling priority of the  3
  281. 3                         job, with respect to the priorities of other jobs    3
  282. 3                         in the queue                                       3
  283. 3/RELEASE                 Releases a previously held job                     3
  284. 3/REQUEUE                 Requests that the job be moved from the original   3
  285. 3                        queue to the specified queue; this qualifier can    3
  286. 3                        also be used with the STOP/QUEUE/ENTRY command        3
  287. @DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDY
  288.  
  289. 5.4.3.1 HOLDING AND RELEASING A JOB
  290.  
  291. The /HOLD qualifier of the SET ENTRY command controls whether a job is to be
  292. made available for immediate processing.  To release a held job, use either
  293. /NOHOLD or the /RELEASE qualifier.
  294.  
  295. To request that the job be held until after a specified time, use the /AFTER
  296. qualifier with the command SET ENTRY.  The job is queued for immediate
  297. processing when the specified time arrives.  The /AFTER=time qualifier
  298. accepts either absolute or delta time values in the format
  299. [dd-mmm-yyy][hh:mm:ss.cc].  You can also specify the following keywords:
  300.  
  301. TODAY
  302. YESTERDAY
  303. TOMORROW
  304.  
  305. The following command holds a print job until it is queued for processing at
  306. the specified date and time:
  307.  
  308. $ SET ENTRY 1121/AFTER=12-JUL-1988:17:30
  309.  
  310. You can use the /NOAFTER qualifier to release immediately a job that is
  311. being held until a specified time.
  312.  
  313. The /RELEASE qualifier releases a job that is being held for any of the
  314. following reasons:
  315.  
  316. :  A job was submitted with the /HOLD qualifier
  317. :  A completed job was held in a queue by the /RETAIN qualifier
  318. :  A job was submitted with the /AFTER qualifier
  319.  
  320. Use the SET ENTRY command with the /HOLD and /RELEASE qualifiers to hold and
  321. release a batch job.  This procedure applies only to a batch job that is
  322. currently in a pending state(that is, a job that has not yet begun to
  323. execute).  The following example shows how to hold and release a batch job
  324. that has not begun execution:
  325.  
  326. $ SET ENTRY 1234/HOLD
  327. $ SET ENTRY 1234/RELEASE
  328.  
  329. 5.4.3.2  REQUEUING A JOB
  330.  
  331. To requeue a job that has not begun execution, use the SET ENTRY /requeue
  332. COMMAND.  If you want to requeue a job that has already begun execution, use
  333. the STOP/QUEUE/REQUEUE command.  The STOP/QUEUE/REQUEUE command suspends the
  334. currently executing job and requeues it to the specified queue, for example:
  335.  
  336. $ STOP/QUEUE/REQUEUE=ALPHA_LPA0 ALPHA_LPB0
  337.  
  338. This command causes the executing print job on ALPHA_LPB0 to be stopped and
  339. requeue to ALPHA_LPA0.  The queue does not stop; only the currently
  340. executing job is affected.  Other jobs remain pending in the queue until
  341. they are processed.
  342.  
  343. You can further qualify the STOP/QUEUE/REQUEUE command with the /HOLD
  344. qualifier.  To hold an aborted print job, enter the STOP/QUEUE/REQUEUE/HOLD
  345. command in the following format:
  346.  
  347. STOP/QUEUE/REQUEUE/HOLD [queue-name]
  348.  
  349. When you specify /HOLD, the aborted job is placed in a hold state for later
  350. release with the SET ENTRY/RELEASE command.  If you do not need to process a
  351. job that is being held in a queue, you can delete the job with the
  352. DELETE/ENTRY command.
  353.  
  354. NOTE:  If you are requeuing a job on a batch queue, you must include the
  355. /ENTRY=n qualifier, for example:
  356.  
  357. $ STOP/QUEUE/ENTRY=1251/REQUEUE=FRED_BATCH
  358.  
  359. 5.4.3.3  CHANGING THE SCHEDULING PRIORITY OF A JOB
  360.  
  361. You can change the scheduling priority of a job by using the /PRIORITY=n
  362. qualifier with the SET ENTRY command.  Do not confuse the job scheduling
  363. priority with the base priority of a queue.
  364.  
  365. The job scheduling priority value must be in a range of 0 through 255, where
  366. 0 is the lowest priority and 255 is the highest.  The default value for
  367. /PRIORITY is the value of the SYSGEN parameter DEFQUERPRI(usually set at
  368. 100).  You must have either OPER or ALTPRI privilege to raise the priority
  369. value above the value of the SYSGEN parameter MAXQUERPRI.  No privilege is
  370. needed to set the priority of your own job lower than the MAXQUERPRI value.
  371. The following example changes the priority of a job to 50:
  372.  
  373. $ SET ENTRY 1131/PRIORITY=50
  374.  
  375. $END OF CHAPTER 5
  376.  
  377. [OTHER WORLD BBS]
  378.  
  379.  
  380.  
  381.  
  382. Downloaded From P-80 International Information Systems 304-744-2253 12yrs+
  383.